Deprecate gdk_visual_get_byte_order

This function is only useful when working with XImages,
and is not meaningfully implemented in other backends.

diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index e3c5b6f9c1a24d8e6b7f2a19660ab628f63792b9..82305fc90afd6ff50033724a01c3e72225c29c83 100644 (file)
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -302,10 +302,15 @@ gdk_visual_get_depth (GdkVisual *visual)
  * @visual: A #GdkVisual.
  *
  * Returns the byte order of this visual.
+ * The information returned by this function is only relevant
+ * when working with XImages, and not all backends return
+ * meaningful information for this.
  *
  * Returns: A #GdkByteOrder stating the byte order of @visual.
  *
  * Since: 2.22
+ *
+ * Deprecated: 3.22: This information is not useful
  */
 GdkByteOrder
 gdk_visual_get_byte_order (GdkVisual *visual)
@@ -344,7 +349,8 @@ gdk_visual_get_colormap_size (GdkVisual *visual)
  *
  * Since: 2.22
  *
- * Deprecated: 3.22. Use gdk_visual_get_red_pixel_details() and its variants
+ * Deprecated: 3.22. Use gdk_visual_get_red_pixel_details() and its variants to
+ *     learn about the pixel layout of TrueColor and DirectColor visuals
  */
 gint
 gdk_visual_get_bits_per_rgb (GdkVisual *visual)

diff --git a/gdk/gdkvisual.h b/gdk/gdkvisual.h
index 3f603a3989d6ea32493814c28c9a3289cc05d8a2..84337aaddc0cb7d5fe77517e20f896e719f41d5e 100644 (file)
--- a/gdk/gdkvisual.h
+++ b/gdk/gdkvisual.h
@@ -115,7 +115,7 @@ GDK_AVAILABLE_IN_ALL
 GdkVisualType gdk_visual_get_visual_type         (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_depth               (GdkVisual *visual);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 GdkByteOrder  gdk_visual_get_byte_order          (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_colormap_size       (GdkVisual *visual);